Метод IXMLStorageNode::FindChildNodeByAttributeValue

Выполняет поиск XML-узла по его имени и значению атрибута.

IDL

[id(109027)]
HRESULT FindChildNodeByAttributeValue(
    [in] BSTR ChildNodeName, 
    [in] BSTR AttributeName, 
    [in] BSTR AttributeValue, 
    [out, retval] IXMLStorageNode** Value
);

Параметры

Параметры	Описание
ChildNodeName	Имя узла
AttributeName	Имя атрибута
AttributeValue	Значение атрибута
Value	Возвращаемое значение

Возвращаемое значение

Экземпляр класса, реализующего интерфейс IXMLStorageNode.

Описание

Выполняет поиск в коллекции XML-узлов (IXMLStorageNode::Items).

Метод проверяет все подчиненные узлы, имя которых (IXMLStorageNode::Name) совпадает с именем, переданным в параметре. Найденный узел проверяется на наличие атрибута, имя и значение которого равны значениям, переданным в параметрах.

Метод возвращает первый найденный XML-узел (IXMLStorageNode), у которого имя, атрибут и значение атрибута соответствуют переданным параметрам. Если узел с требуемыми параметрами не найден, то метод возвращает пустое значение.

Примечания

№	Описание
1.	Поиск по имени XML-узла является регистрозависимым.
2.	Поиск по имени XML-атрибута является регистрозависимым.